---
title: "Introduction"
description: "Get started with Chonkie's Cloud API for intelligent text processing and RAG"
icon: "rocket"
---

Welcome to Chonkie's API! Build powerful AI applications with enterprise-grade text chunking, semantic search, and intelligent agents.

## Available APIs

Chonkie provides two complementary APIs:

### Chunking & Embedding API

**Base URL**: `https://api.chonkie.ai`

Transform raw text into perfectly-sized, semantically meaningful chunks for RAG applications.

- **All Chunkers** - Split your documents using our finetuned chunkers
- **All Refineries** - Add embeddings and overlap for better retrieval
- **Multiple Embeddings** - Support for all major embedding models

### Labs API

**Base URL**: `https://labs.chonkie.ai/api`

Build AI applications with persistent knowledge and intelligent agents. This is _Context as a Service_:

- **Knowledge Bases** - Store and index documents with automatic chunking and embedding
- **Semantic Search** - Three-mode search (fast/balanced/deep) over your documents
- **AI Agents** - Create LLM powered agents over your documents in natural language
- **MCP Integration** - Connect your data to desktop apps or IDEs with one click MCP deployments

## Quick Start

### 1. Get Your API Key

Sign up at [labs.chonkie.ai](https://labs.chonkie.ai) to get your API key.

### 2. Install SDK (Optional)

<CodeGroup>

```bash Python
pip install chonkie[cloud]
```

```bash JavaScript
npm install @chonkiejs/cloud
```

</CodeGroup>

### 3. Make Your First Request

<CodeGroup>

```python Python - Chunking
from chonkie.cloud import TokenChunker

# Initialize chunker
chunker = TokenChunker(
    chunk_size=512,
    chunk_overlap=50
)

# Chunk your text
text = "Your long document here..."
chunks = chunker.chunk(text)

print(f"Created {len(chunks)} chunks")
```

```javascript JavaScript - Chunking
import { TokenChunker } from "@chonkiejs/cloud";

// Initialize chunker
const chunker = new TokenChunker({
  chunkSize: 512,
  chunkOverlap: 50,
});

// Chunk your text
const text = "Your long document here...";
const chunks = await chunker.chunk({ text });

console.log(`Created ${chunks.length} chunks`);
```

```python Python - Knowledge Base
import requests

# Create knowledge base
response = requests.post(
    "https://labs.chonkie.ai/api/v1/knowledge",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "name": "My Docs",
        "description": "Product documentation"
    }
)

kb = response.json()
print(f"Created: {kb['slug']}")
```

```javascript JavaScript - Knowledge Base
// Create knowledge base
const response = await fetch("https://labs.chonkie.ai/api/v1/knowledge", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "My Docs",
    description: "Product documentation",
  }),
});

const kb = await response.json();
console.log(`Created: ${kb.slug}`);
```

</CodeGroup>

## Authentication

All API requests require authentication using Bearer tokens:

```bash
Authorization: Bearer YOUR_API_KEY
```

## SDKs and Libraries

Official SDKs available:

- **Python**: `pip install chonkie[cloud]` - [GitHub](https://github.com/chonkie-ai/chonkie)
- **JavaScript/TypeScript**: `npm install @chonkiejs/cloud` - [GitHub](https://github.com/chonkie-ai/chonkiejs)

## Getting Help

Need assistance?

- **Documentation**: Browse the sidebar for detailed guides
- **Discord Community**: [Join us!](https://discord.gg/Q6zkP8w6ur)
- **Email Support**: [support@chonkie.ai](mailto:support@chonkie.ai)
- **GitHub Issues**: [Report your first issue!](https://github.com/chonkie-ai/chonkie/issues)

## What's Next?

<CardGroup cols={2}>

<Card title="Try the Playground" icon="flask" href="/api/common/playground">
  Test chunkers visually on our interactive web app
</Card>

<Card
  title="CHONK your first document"
  icon="scissors"
  href="/api/chunking/token-chunker"
>
  Start chunking text for your RAG pipeline
</Card>

<Card
  title="Create a Knowledge Base"
  icon="database"
  href="/api/knowledge/create"
>
  Store and search documents at scale
</Card>

<Card title="Deploy an Agent" icon="robot" href="/api/agents/create">
  Build AI assistants with knowledge integration
</Card>

</CardGroup>
